home *** CD-ROM | disk | FTP | other *** search
/ Power Programmierung 2 / Power-Programmierung CD 2 (Tewi)(1994).iso / c / library / dos / diverses / him / himread.me < prev    next >
Encoding:
Text File  |  1989-01-03  |  17.5 KB  |  390 lines
  1. HIMREAD.ME for HIM Version 1.1  11/88
  2.  
  3. HIM - The Human Interface Manager from ALLSOFT is a library of more than 230 
  4. functions and macros designed for use in C programs.  HIM makes designing and
  5. coding user interfaces much easier by providing a rich set of functions 
  6. designed specifically for presenting information to, and obtaining information
  7. from a user of your application.
  8.  
  9. Compilers Supported
  10.  
  11. The HIM library has been successfully tested using the Microsoft C V4.0, 5.0,
  12. 5.1 and Borland Turbo C V1.5 and 2.0 compilers.  Others will be supported in 
  13. the near future.
  14.  
  15. Components
  16.  
  17. HIM is divided into 7 separate categories, each performing a different task 
  18. relating to managing a user interface.
  19.  
  20. List Manager - With the List Manager your application can create a list, add and
  21. delete any kind of data structure to the list, sort with the option of using 
  22. your comparision routine, and query items in the list via search, next, and 
  23. previous functions.
  24.  
  25. Keyboard Manager - No more messy switch statements every time you ask for a key.
  26. Just tell the Keyboard Manager what function to call when a certain key is
  27. pressed and the routing is handled for you!  Multiple input sources, outputs,
  28. and journal files are supported as well as the ability to define a background
  29. routine which will be called repeatably while waiting for input.
  30.  
  31. Window Manager - Yes, it does do windows (sorry, no floors).  Colors, titles on
  32. 4 sides, and a rich set of output and editing functions will give your
  33. applications that snappy and professional look.  Flexible output with color is
  34. available with our printf() look-alike, wnprintf().  Full data entry capability
  35. is supported with our bullet-proof wninput() routine which supports all of the
  36. C data types.
  37.  
  38. Help Manager - Nothing is appreciated more by a user than a program with
  39. complete online documentation.  The Help Manager in combination with the
  40. Keyboard Manager's ability to trap specific keycodes (F1 maybe??) gives you the
  41. option of providing online help easily and painlessly.  All you need to do is
  42. inform the help manager what help should be given at different points in your
  43. program, when the user asks for help it will be there.
  44.  
  45. Menu Manager - The normally messy chore of providing menus is easy with the Menu
  46. Manager, just create a menu, add menu items to it and call the process function!
  47. Different flavors of menus such as Pop-Up, Pull-Down, and Lotus style Light-Bar
  48. are available.  Menu elements can be made read-only dynamically so you can
  49. disable user options if other criteria in your application have not been met.
  50. In addition to full control over placement, menu items can have a C routine
  51. assigned or another menu called when the element is picked by the user.
  52.  
  53. Forms Manager (optional) - Data entry couldn't be easier.  With the Forms 
  54. Manager you have the ability of completely defining a input screen, field types,
  55. flow thru the screen, individual data field help, and validation.  Using these 
  56. functions in combination with the Form Painter program lets you code an 
  57. application in hours instead of days!
  58.  
  59. Form Painter (optional) - Used in combination with the Forms Manager, this nifty
  60. utility lets you completely define forms "on-screen", enter help text, and
  61. test the forms for proper input validation.  After the forms have been defined
  62. you can keep them in their Screen Definition File (SDF) for later use at runtime
  63. or create C source code which becomes part of your finished application program.
  64.  
  65. Shareware
  66.  
  67. Allsoft distributes HIM with the marketing approach called "shareware".  The
  68. diskette(s) with the base library files (EXCLUDING forms and forms painter)
  69. can be freely copied and shared with others, or purchased from Allsoft for a
  70. small fee.  We ask you to help us distribute HIM by sharing unmodified copies
  71. of the diskette, to make it easy for other people to try HIM.  We also permit
  72. unlimited copying of the diskette(s) to make it easy for people in a company,
  73. school, or other group to use HIM.
  74.  
  75.  
  76. Support and continued development of HIM depends on programmers who "register"
  77. their copy of the HIM library.  Registration has a number of benefits:
  78.  
  79.     - A hardbound copy of the full Human Interface Manager manual.
  80.     - Diskettes with your unique registration number.
  81.     - Allsoft support service for one year:
  82.         - Compuserve E-mail for technical questions.
  83.         - Software updates.
  84.     - C source code for base HIM library (EXCLUDING forms and form painter).
  85.     - Option to buy Forms Manager and Form Painter utility.
  86.     - Thanks from us for your support and encouragement!
  87.  
  88.  
  89. Your registration makes it possible for us to enhance HIM with new
  90. features YOU want to see and support if you have technical problems or
  91. questions.  We believe every user of HIM should have one of our manuals.
  92.  
  93. You MUST register if you incorporate any HIM routine(s) in a commercial software
  94. program.  You must NOT use any HIM routine(s) in a competing product.  There is
  95. no royalty due for registered users.
  96.  
  97. Registered owners receive a commission when someone else registers from one of
  98. their copies.  People who like HIM register and give copies to friends or 
  99. associates with IBM PC's or compatibles.  The commission is our way of thanking
  100. you for distributing HIM.
  101.  
  102. Allsoft sells HIM manuals and other materials in quantity.  Larger organizations
  103. often copy the diskette and buy our manuals.  Registration for yearly support
  104. service is available separately if you already have a manual.  Call or write
  105. for a full price list.
  106.  
  107. We really do encourage you to give away HIM diskettes...with some restrictions.
  108. As the copyright owner, Allsoft will permit you to give away copies of
  109. the HIM library(s) diskette, with the following restrictions:
  110.  
  111.     - You must NOT distribute the Forms Manager or Form Painter software.
  112.     - You must distribute ALL files on the base HIM library diskette(s).
  113.     - You must NOT distribute copies of the printed manual.
  114.     - You must NOT distribute any files from the HIM SOURCE diskette(s).
  115.     - You must use Allsoft copyright notices on media with Allsoft files.
  116.     - You must use Allsoft trademark notices on "Allsoft" and "HIM".
  117.  
  118. You may add your own files, put files on several diskettes, distribute files
  119. via modem, or compress files as long as their contents remain unchanged.  You
  120. may print, copy, and distribute any text (OTHER THAN SOURCE CODE) contained 
  121. on the disks.
  122.  
  123.  
  124. Registration
  125.  
  126. To register, send a check or call us with your Visa/MasterCard number.  We also
  127. accept purchase orders from established companies or organizations.  If your
  128. copy of HIM came from someone else, we need your old registration number to
  129. credit the owner.  You can get your new registration number over the phone or
  130. by mail on your diskette(s).  Use the order form following this section or
  131. print the file HIMORDER.DOC to print your own.
  132.  
  133. When you get a registered copy from Allsoft, you receive new HIM diskettes with
  134. your registration number on them.  Use this number for technical support and
  135. make sure to write it on any copies you make for associates so that the
  136. commission, currently $15.00, can be properly sent to you.
  137.  
  138.  
  139. Technical Support
  140.  
  141. Technical support is obtained by one of two ways; phone call-back or Compuserve
  142. E-mail.
  143.  
  144.     The phone call-back number is:
  145.  
  146.             (505) 821-7760
  147.  
  148.     The Compuserve E-Mail tech support account is:
  149.  
  150.             [76505,2014]
  151.  
  152. Be sure to give your registration number, name, and a voice phone number where
  153. you can be reached.  If your problem is of any complexity don't bother 
  154. explaining it via E-mail, just leave your registration number, name, and phone,
  155. voice is faster than typing!
  156.  
  157.  
  158. New Features in Version 1.1
  159.  
  160. The HIM Window Manager has 2 new features that take a load off application
  161. developers.  The first is a screen editor, wneditstring(), which lets your users
  162. scroll, page, and edit a string buffer in a window you have built all with one
  163. routine call!  The second feature is a bullet-proof data input routine, 
  164. wninput(), which allows entry of all the C data types in a region of a window
  165. you specify.  While wninput() doesn't have near the power of the Forms Manager,
  166. it does allow you to specify a valid character list, input length, wipe on first
  167. character, and display only mode.  A sample program has been included which
  168. shows how to operate this routine in a "screen" mode which has many fields and
  169. allows arrow movement between the fields.
  170.  
  171. The Menu Manager has been completely redesigned.  Pop-up, pull-down, and Lotus
  172. style light-bar menus are now available with any level of nesting.  Menu items
  173. can have a C routine or another menu called when selected, or one C routine can
  174. be called to handle the whole menu.  Items can be made read-only during the run
  175. of your program so that they can't be selected.  In the Pop-up menu, items can
  176. be marked and unmarked by the user with a key of your choice for batch
  177. processing.  Display only lists are handled by making all menu items read-only
  178. and calling the menu process routine (mmpromenu()).
  179.  
  180.  
  181. BBS Distribution
  182.  
  183. The shareware base HIM package as distributed on BBS's contains only the
  184. large model library  himmsl.lib  compiled under Microsoft C V5.0 or Borland
  185. Turbo C V1.5.  The shareware package purchased from Allsoft contains all library
  186. models for the compiler you specify.  This was necessary as the ARC file is 
  187. already over 200k bytes.
  188.  
  189. The HIM manual, himswman.doc, is set for 58 lines/page 80 characters
  190. wide.  If you register, the manual you will receive is standard 8.5 X 6.5
  191. double sided printing with hard cover.  If your printer can't print the
  192. IBM box drawing characters some of the window examples in the manual may have
  193. some pretty weird looking symbols.
  194.  
  195. The BBS distributed manual can be obtained in it's original form by merely
  196. un-arc'ing the file HIM110MS.ARC (Microsoft) or HIM110TC.ARC (Turbo).
  197.  
  198.  
  199. ALLSOFT Shareware Distribution
  200.  
  201. The manual as shipped by Allsoft is on 2 files in compressed form on DISK # 1
  202. and DISK #2 with the filenames  HIMMAN1.CMP and HIMMAN2.CMP.  To decompress
  203. the manual into readable form use the following command at the DOS prompt:
  204.  
  205.     decomp  himman1.cmp  himman1.doc
  206.  
  207. If you want to print directly from the compressed version:
  208.  
  209.     decomp  himman1.cmp  prn:
  210.  
  211. You will need approximately 520k bytes of disk space for the de-compressed
  212. manual.
  213.  
  214. There are several demos packaged with both distributions:
  215.  
  216.   kmdemo1.c  -    Shows how a mouse can be setup to "look" like arrow
  217.                   keys using the Keyboard Manager User Input Routines.
  218.                   Needs MSMOUSE.lib mouse library.
  219.  
  220.   wndemo1.c  -    Window manager wninput() demo for all C data types.  Shows
  221.                   how to do data "screen" input of multiple fields.
  222.  
  223.   hmdemo1.c  -    Examples on setting intercept routines using the
  224.                   Keyboard manager and using the Help Manager for 
  225.                   displaying context sensitive help.
  226.  
  227.   mfdel.c    -    Program which displays all files in current directory,
  228.                   allows files to be "marked" and deletes all marked files.
  229.                   Files which are read-only will be displayed as such in the
  230.                   menu and will not be selectable.
  231.  
  232.   mmdemo1.c  -    Pop-Up menu which emulates the first 3 levels of 1-2-3.
  233.  
  234.   mmdemo2.c  -    Light-Bar menu which emulates first 3 levels of 1-2-3.
  235.  
  236.   mmdemo3.c  -    Pull-Down menu which emulates first 3 levels of 1-2-3.
  237.  
  238.   addbook.c  -    Complete address book program which uses the optional
  239.                   HIM Forms Manager library. (ALLSOFT distribution only)
  240.  
  241.  
  242. Ordering
  243.  
  244. A registration order form, himorder.doc, is available on this distribution
  245. if you would like to register your copy of the HIM library.  The Forms 
  246. Manager and Form Painter extension of HIM, including all source code is 
  247. available to registered users (see HIMORDER.DOC).
  248.  
  249.  
  250. Arc file contents of the MSC5.0 BBS distribution should be:
  251.  
  252. HIMSWMAN DOC   shareware HIM manual, 310+ pages
  253. HIMMSL   LIB   large model HIM library MSC 5.0
  254. LM       H     list manager include file
  255. KM       H     keyboard manager include file
  256. HM       H     help manager include file
  257. WN       H     window manager include file
  258. MM       H     menu manager include file
  259. HFBILDER EXE   builds help file for use by Help Manager
  260. WNDEMO1  C     window manager wninput() data entry demo
  261. WNDEM1MS MAK   makefile for wndemo1.c, Microsoft Make
  262. HMDEMO1  C     C source for Help Manager demo
  263. HMDEM1MS MAK   makefile for hmdemo1.c, Microsoft Make
  264. KMDEMO1  C     C source for Keyboard Manager demo
  265. KMDEM1MS MAK   makefile for kmdemo1.c, Microsoft Make
  266. MFDEL    C     menu oriented file delete demo
  267. MFDELMS  MAK   makefile for mfdel.c, Microsoft Make
  268. MMDEMO1  C     pop-up menu demo
  269. MMDEM1MS MAK   makefile for mmdemo1.c, Microsoft Make
  270. MMDEMO2  C     light-bar menu demo
  271. MMDEM2MS MAK   makefile for mmdemo2.c, Microsoft Make
  272. MMDEMO3  C     pull-down menu demo
  273. MMDEM3MS MAK   makefile for mmdemo3.c, Microsoft Make
  274. HELPFILE TXT   input text for hmdemo1.c
  275. HELPFILE HLP   file used by hmdemo1.c
  276. HIMORDER DOC   registration order form
  277. HIMREAD  ME    this file
  278.  
  279. Arc file contents of the Turbo 1.5 BBS distribution should be:
  280.  
  281. HIMSWMAN DOC   shareware HIM manual, 310+ pages
  282. HIMTCL   LIB   large model HIM library Turbo C 1.5
  283. LM       H     list manager include file
  284. KM       H     keyboard manager include file
  285. HM       H     help manager include file
  286. WN       H     window manager include file
  287. MM       H     menu manager include file
  288. HFBILDER EXE   builds help file for use by Help Manager
  289. WNDEMO1  C     window manager wninput() data entry demo
  290. WNDEM1TC MAK   makefile for wndemo1.c, Turbo Make
  291. HMDEMO1  C     C source for Help Manager demo
  292. HMDEM1TC MAK   makefile for hmdemo1.c, Turbo Make
  293. KMDEMO1  C     C source for Keyboard Manager demo
  294. KMDEM1TC MAK   makefile for kmdemo1.c, Turbo Make
  295. MFDEL    C     menu oriented file delete demo
  296. MFDELTC  MAK   makefile for mfdel.c, Turbo Make
  297. MMDEMO1  C     pop-up menu demo
  298. MMDEM1TC MAK   makefile for mmdemo1.c, Turbo Make
  299. MMDEMO2  C     light-bar menu demo
  300. MMDEM2TC MAK   makefile for mmdemo2.c, Turbo Make
  301. MMDEMO3  C     pull-down menu demo
  302. MMDEM3TC MAK   makefile for mmdemo3.c, Turbo Make
  303. HELPFILE TXT   input text for hmdemo1.c
  304. HELPFILE HLP   file used by hmdemo1.c
  305. HIMORDER DOC   registration order form
  306. HIMREAD  ME    this file
  307.  
  308.  
  309. Distribution Disk contents from Allsoft should be:
  310.  
  311. Disk # 1
  312.  
  313. DECOMP   EXE   Decompresses HIMMAN1.CMP & HIMMAN2.CMP
  314. HIMMAN1  CMP   Compressed HIM reference manual (part 1)
  315. HIMORDER DOC   HIM order form
  316. HIMREAD  ME    This file
  317. HIMNOTES DOC   Latest manual changes
  318.  
  319. Disk # 2
  320.  
  321. HIMMAN2  CMP   Compressed HIM reference manual (part 2)
  322. HIMxxL   LIB   HIM library, large   model. Microsoft (xx=MS), Turbo (xx=TC)
  323. HIMxxM   LIB   HIM library, medium  model. Microsoft (xx=MS), Turbo (xx=TC)
  324. HIMxxC   LIB   HIM library, compact model. Microsoft (xx=MS), Turbo (xx=TC)
  325. HIMxxS   LIB   HIM library, small   model. Microsoft (xx=MS), Turbo (xx=TC)
  326. HM       H     Help Manager include file
  327. KM       H     Keyboard Manager include file
  328. LM       H     List Manager include file
  329. MM       H     Menu Manager include file
  330. WN       H     Window Manager include file
  331. HFBILDER EXE   Converts help file into Help Manager format
  332.  
  333. Disk # 3
  334.  
  335. WNDEMO1  C     window manager wninput() data entry demo
  336. WNDEM1xx MAK   makefile for wndemo1.c, (TC=Turbo , MS=Microsoft)
  337. HMDEMO1  C     C source for Help Manager demo
  338. HMDEM1xx MAK   makefile for hmdemo1.c, (TC=Turbo , MS=Microsoft)
  339. KMDEMO1  C     C source for Keyboard Manager demo
  340. KMDEM1xx MAK   makefile for kmdemo1.c, (TC=Turbo , MS=Microsoft)
  341. MFDEL    C     menu oriented file delete demo
  342. MFDELxx  MAK   makefile for mfdel.c, (TC=Turbo , MS=Microsoft)
  343. MMDEMO1  C     pop-up menu demo
  344. MMDEM1xx MAK   makefile for mmdemo1.c, (TC=Turbo , MS=Microsoft)
  345. MMDEMO2  C     light-bar menu demo
  346. MMDEM2xx MAK   makefile for mmdemo2.c, (TC=Turbo , MS=Microsoft)
  347. MMDEMO3  C     pull-down menu demo
  348. MMDEM3xx MAK   makefile for mmdemo3.c, (TC=Turbo , MS=Microsoft)
  349. HELPFILE TXT   input text for hmdemo1.c
  350. HELPFILE HLP   file used by hmdemo1.c
  351.  
  352.   ** Forms Manager Demo ** 
  353.  
  354. ADDBOOK  TXT   Help file for ADDBOOK.EXE (unformatted)
  355. ADDBOOK  HLP   Help file for ADDBOOK.EXE (formatted)
  356. ADDRESS  SDF   Screen Def. file created by FPAINTER.EXE
  357. ADDRESS  C     Source code created by FPAINTER.EXE
  358. ADDRESS  H     Include file created by FPAINTER.EXE
  359. ADDBOOK  C     Source code for address book demo program
  360. ADBOOKxx MAK   Make file for ADDBOOK.EXE, (TC=Turbo , MS=Microsoft)
  361. ADDBOOK  EXE   Executable demo
  362.  
  363. Please share these disks with your fellow programmers.  When a order comes
  364. in from your registered copy we'll send you a $15.00 commission.
  365.  
  366. Getting Started
  367.  
  368. 1. Copy the .lib files to your libraries sub-directory and set environment
  369.    variables or the turboc.cfg file to point to this sub-dir.
  370.  
  371. 2. Copy the .h files to your includes sub-directory and set environment
  372.    varialbes or the turboc.cfg file to point to this sub-dir.
  373.  
  374. 3. Copy all demo programs and makefiles to a working subdirectory.
  375.  
  376. 4. Compile all demos using appropriate .mak files with your compiler
  377.    "make" utility.  See comments at top of .mak file for usage.
  378.  
  379. Source Code
  380.  
  381. Registered HIM users get a card good for 2 HIM updates OR the complete C
  382. source code, free of charge.  Additional updates can be purchased for a
  383. small fee.  See the HIMORDER.doc file.
  384.  
  385.  
  386. Thank you for your interest in the Human Interface Manager from ALLSOFT.  We
  387. are so sure it will handle your most demanding user interface task that you
  388. can "try it before you buy it".
  389.  
  390.